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Preface 


Intended Audience 


This document is for those people who must debug system code, especially 
device drivers and other images that execute in privileged processor-access 
modes or at an elevated IPL. 


Conventions Used in This Document 


Convention 

Meaning 

[ret] 

A symbol with a one- to three-character 
abbreviation indicates that you press a key 
on the terminal, for example, 1 ret| . 

ICTRL/xl 

The phrase CTRL/x indicates that you must press 
the key labeled CTRL while you simultaneously 
press another key, for example, CTRL/C, 

CTRL/Y, CTRL/O. 

$ SHOW TIME 
05-JUN-1985 11:55:22 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

$ TYPE MYFILE.DAT 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would 
display in response to the particular command is 
shown or that not all the data a user would enter 
is shown. 

file-spec,... 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be 
entered. 

[logical-name] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to 
double quotation marks ("). The term apostrophe 
(') is used to ref to a single quotation mark. 


V 














Preface 


Structure of This Document 


This document is composed of three major sections. 

The Format Section is an overview of DELTA and XDELTA, and is intended 
as a quick reference guide. The format summary contains the DCL commands 
that invoke DELTA, listing all qualifiers and parameters. The usage summary 
describes how to invoke and exit from the DELTA and XDELTA, and any 
restrictions you should be aware of. The command summary lists all DELTA'S 
and XDELTA's commands. 

The Description Section explains how to use DELTA and XDELTA. 

The Commands Section describes each of DELTA'S and XDELTA's 
commands. The commands appear in alphabetical order. 







DELTA/XDELTA 


DELTA/XDELTA 

DELTA and XDELTA are debugging tools that you can use to 
monitor the execution of user programs and the VAX/VMS 
operating system. They are documented together here because 
most of their commands are identical. 

You can use DELTA to debug user-mode programs or programs that 
execute at IPL 0 in any processor mode. You can use XDELTA to 
debug programs that execute in any processor mode and at any IPL. 
You cannot use DELTA to debug code that executes at an elevated 
IPL. 


FORMAT $ RUN SYS$LIBRARY:DELTA 


Command Qualifiers Defaults 

None. None. 

Command Parameters 

None. 


usage summary Invoking 

To use DELTA to debug a program, link the program with the 
/DEBUG qualifier. Then define the logical name LIB$DEBUG to be 
SYS$LIBRARY:DELTA.EXE. Then use the RUN command to run the program. 


To debug code that executes at an elevated IPL, including driver code and the 
executive, use XDELTA. You should use XDELTA on a stand-alone system 
because it interferes with normal timesharing operations. 

Exiting 

To exit from DELTA, type the EXIT command. 

To exit from XDELTA, use the ;P command to proceed from the breakpoint. 

Directing Output 

You cannot redirect output from DELTA or XDELTA; but, because you use 
XDELTA at the console terminal, you will have a written record of your 
activity when you use XDELTA. 

Privileges/Restrictions 

To run DELTA in a processor mode other than user mode, your process must 
have the privilege that allows DELTA to change to that mode: change-mode- 
to-executive (CMEXEC) or change-mode-to-kemel (CMKRNL) privilege. 
Furthermore, when DELTA encounters a breakpoint, it gets control in the 
access mode prevailing when it encountered the breakpoint. 
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DELTA/XDELTA 

Description 


commands 


DESCRIPTION 


1 Using DELTA 


Furthermore, to use the ;M command in DELTA, your process must have 
change-mode-to-kemel (CMKRNL) privilege. 

To use XDELTA, you must be able to boot the system. 


Syntax 

[address-expression] command [expression] 

DELTA/XDELTA Commands 

1 return 1 (Close Current Location) 

I linefeed 1 (Close Current Location and Open Next) 

I esc I (Open and Display Previous Location) 

= (Display Value of Expression) 

;E (Execute Command String) 

;G (Go) 

/ (Open Location and Display Contents in Prevailing Mode) 

I (Open Location and Display Contents in Instruction Mode) 
I tab I (Open Location Specified by Q, the Current Value) 

;P (Proceed from Breakpoint) 

" (Set ASCII Mode) 

;X (Set Base Register) 

;B (Set, Clear, or Display Breakpoint) 

[ (Set Display Mode) 

S (Step Instruction) 

O (Step Instruction Over Subroutine) 

;M (Set All Processes Writeable) 

'string' (Deposit ASCII String) 


Both DELTA and XDELTA have the same commands, use the same 
expressions, and can be used to debug programs. But they are different: 
you use them to debug different kinds of code, and you invoke and exit from 
them in different ways. 

The next few sections describe these differences. Later sections describe the 
DELTA and XDELTA commands, which are, for the most part, identical. 


You can use DELTA to debug programs that execute at IPL 0. To debug 
a program that executes in user mode, you need no privileges. To debug 
a program that executes in another processor-access mode, the process in 
which you link your program must have the necessary privileges. If your 
program executes in executive mode, for example, your process must have 
change-mode-to-executive (CMEXEC) privilege. 
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DELTA/XDELTA 

Description 


Invoking DELTA 

To invoke DELTA, give your process the privileges needed to perform the 
change-mode instructions the program contains. Then link your program 
with DELTA, and use the RUN command to execute your program. 

The following commands link DELTA with your program and start the 
debugging process: 

$ LINK program-name 

$ DEFINE LIBSDEBUG SYS$LIBRARY:DELTA 
$ RUN/DEBUG program-name 

When DELTA begins execution, it displays its name and its current version 
number, like this: 

DELTA Version 2.3 

DELTA then executes a breakpoint on the first instruction in the program with 
which it is linked. It displays the address of that instruction, a slash (/), and 
the instruction and its operands. DELTA is then ready for your commands. 


Exiting from DELTA 

To exit from DELTA, type EXIT. 

If you have defined a symbol named EXIT in your program, DELTA displays 
the value of this symbol. To exit, you must type the EXIT command once 
more. 


Using XDELTA 

You can use XDELTA to debug code that executes at elevated IPL. This code 
includes VAX/VMS executive routines, device drivers, and other privileged 
code. 

Because XDELTA breakpoints interrupt program execution at IPL 31, no other 
system activity can take place. For this reason you should use XDELTA only 
on a stand-alone system. 


Invoking XDELTA 

To use XDELTA, you must bootstrap the system using a command procedure 
that includes XDELTA in the system. You must then request an XDELTA 
interrupt. 

The procedures for bootstrapping the system with XDELTA differ depending 
on the processor on which the system is being booted. Each one, however, 
causes XDELTA to be included in the system, and causes XDELTA to place 
a breakpoint in the VAX/VMS initialization routine. Execution of the 
breakpoint instruction transfers program control to a fault handler located 
in XDELTA. 
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DELTA/XDELTA 

Description 


2.1.1 Bootstrapping the System on a VAX—11/780 

In addition to the normal system bootstrap command files, the VAX/VMS 
console floppy diskette for a VAX-11/780 contains three command files that 
bootstrap the system with XDELTA: 

• DUAXDT 

• DMAXDT 

• DBAXDT 

To bootstrap the system with XDELTA, follow the procedures in the Guide to 
VAX/VMS System Management and Daily Operations with two exceptions: 

• In R3, deposit the number of the device from which you want to boot the 
system. 

• Specify one of the command files listed above rather than one of the 
command files listed in the Guide to VAX/VMS System Management and 
Daily Operations. 

For example, to bootstrap the system with XDELTA on a VAX-11/780, 
type the following command: 

»>DEP0SIT R3 0 

This command deposits zero, the number of the unit from which to boot the 
system, in R3. 

To invoke the command procedure that boots the system from DM AO, type 
the following command: 

»>QDMAXDT 

The procedure boots the processor and prompts you from SYSBOOT. When 
the SYSBOOT> prompt appears, you can enter any SYSBOOT command. If 
you do not set or load system parameters with the USE command, the system 
uses the parameters stored in the system image. To prevent the system from 
automatically rebooting after a bugcheck, you can set the system parameter 
BUGREBOOT to 0. 

To continue the bootstrapping operation, type the CONTINUE command. 


2.1.2 Bootstrapping the System with XDELTA on a VAX—11/750 or 

MicroVAX I 

To bootstrap VAX/VMS with XDELTA on a VAX-11/750 or a MicroVAX I, 
issue the following command: 

»>B/n device-name 

The B is the console's BOOT command. 

The device-name is the name of the device from which to bootstrap the 
system. Specify the device-name using the format ddcu. (See the Guide to 
VAX/VMS System Management and Daily Operations or the MicroVMS User's 
Manual for a complete description of the format of device names.) You must 
specify identifiers for both the controller and the unit identifiers; there are no 
defaults. 


DELTA-4 








DELTA/XDELTA 

Description 


2.1.3 


The /n qualifier loads the value n into R5. The contents of R5 are passed 
as input to VMB.EXE. The value of n must be one of the following 32-bit, 
hexadecimal numbers described below. 


Value Meaning 

0 Normal, nonstop bootstrap (default) 

1 Stop in SYSBOOT (equivalent to @DxyGEN on the VAX-11/780) 

2 Include XDELTA with the system, but do not take the initial breakpoint 

6 Include XDELTA with the system, and take the initial breakpoint 

7 Include XDELTA with the system, stop in SYSBOOT, and take the 

initial breakpoint at system initialization (equivalent to @DxyXDT on the 
VAX-11/750) 


For example, the following command bootstraps the system on a VAX-11 
/780, the bootstrap device being DMAO. 

»>B/7 DMAO 

The /7 qualifier includes XDELTA in the system and stops the booting 
process in SYSBOOT, which prompts you. It also causes XDELTA to set a 
breakpoint in the system initialization routine. 

SYSB00T> 

You can enter SYSBOOT commands when SYSBOOT gives you the 
SYSBOOT> prompt. If you do not set or load system parameters with 
the USE command, the system uses the parameters stored in the system 
image. To prevent the system from automatically rebooting after a bugcheck, 
you can set the system parameter BUGREBOOT to 0. 

To continue the bootstrapping operation, type the CONTINUE command. 

See the VAX-11/750 Software Installation Guide or the MicroVAX I User's 
Manual for further details on the B command. 

To bootstrap the system from the console TU58, see the VAX-11/750 Software 
Installation Guide. The console TU58 contains the command files DUAXDT, 
DMAXDT, and DBAXDT, which contain the command procedures that boot 
the system from DU, DM, and DB devices, respectively. 


Bootstrapping the System on a VAX—11 /730 

In addition to the normal system bootstrap command files, the VAX/VMS 
console DECtape for a VAX-11/730 contains two command files that 
bootstrap the system with XDELTA: DQAXDT and DQOXDT. 

To bootstrap a VAX-11/730 with XDELTA, follow the procedures outlined 
in the VAX-11 /730 Software Installation Guide, but specify DQAXDT or 
DQOXDT. For example, to bootstrap the system with XDELTA on a VAX-11 
/730 using the DQAXDT command procedure, type the following command. 

»> D/G/L 3 1 

This command deposits the unit number, one, in R3. Then type: 

»> QDQAXDT 

This command procedure boots the system from DQA1. 


DELTA-5 







DELTA/XDELTA 

Description 


If the boot device is DQAO, you can omit these two steps, and instead execute 
the command procedure DQOXDT, as shown below. 

»> QDQOXDT 

This command procedure does not require the unit number as a parameter. 

Either of these procedures boots the processor and prompts you from 
SYSBOOT. When SYSBOOT prompts you, you can enter any SYSBOOT 
command. If you do not set or load any system parameters with the USE 
command, the system uses the system parameters stored in the system image. 
To prevent the system from automatically rebooting after a bugcheck, you can 
set the system parameter BUGREBOOT to 0. 

To continue the bootstrapping process, type the following command. 

SYSB00T> CONTINUE 


2.2 Requesting an Interrupt 

When the system has bootstrapped itself, you need to request an XDELTA 
interrupt so that XDELTA gets control of the system. To request a software 
interrupt from which XDELTA gets control on a VAX-11/780, a VAX- 
11/750, or a VAX-11/730, issue the following commands at the console 
terminal: 

$ | CTRL/P | 

»> D/I 14 5 
»> C 

These commands request an interrupt at IPL 5, at which XDELTA gets control 
of the system. 

If your system is a VAX-11/782, request the interrupt at IPL 12 by typing C 
instead of 5 in the example above. (Requesting an XDELTA interrupt at IPL 
12 is also useful in those cases in which the system is hung at an IPL between 
5 and 12.) Type these commands on the console of the primary processor, 
then again on the console of the attached processor. 


2.3 Setting the Initial Breakpoint 

When debugging a device driver's initialization routines, you should set a 
breakpoint in the driver code so that XDELTA encounters the breakpoint 
before any of the driver's initialization routines are called. To do this, place a 
call to the system routine INI$BRK in the code. 

An example of such a call is the following, which calls the INI$BRK system 
routine as a subroutine: 

JSB G~INI$BRK 

You should place such a breakpoint in the driver's code because SYSGEN's 
CONNECT command calls the driver's controller-initialization and unit- 
initialization routines. To debug these routines, you must allow XDELTA to 
gain control of the driver's execution before these routines execute. 

The INI$BRK routine contains two instructions: BPT and RSB. You can use 
the INI$BRK routine as a debugging tool, placing calls to this routine in any 
part of the source code you want to debug. After the break is taken, the 
return address, the address in the driver to which control returns when you 
proceed from the breakpoint, is on the top of the stack. 
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Description 


Note that INI$BRK is defined XDELTA's breakpoint 1. When using XDELTA, 
never clear breakpoint 1. 



# 


2.4 Proceeding from a Breakpoint 

After the system has bootstrapped, it displays its welcoming message and 
halts in XDELTA, which displays this message: 

1 BRK AT nnnnmmn 
address/NOP 

Now XDELTA is waiting for input. (In most circumstances XDELTA does 
not prompt you.) Usually, you proceed from this point with the following 
command: 

;P 

If the system halts with a fatal bugcheck, the system prints the bugcheck 
information on the console terminal. Then, if the system parameter 
BUGREBOOT was set to 0, XDELTA prompts you. Bugcheck information 
consists of: 

• The type of bugcheck 

• The contents of the registers 

• A dump of one or more stacks 

The contents of the PC and the stack indicate the cause of the failure, usually 
an error in a user-written device driver. You can then examine the system's 
state further by issuing XDELTA commands. 


2.5 



3 



Exiting from XDELTA 

Exit from XDELTA by clearing all breakpoints but breakpoint 1 and 
proceeding from the breakpoint with the ;P command. 


Using DELTA and XDELTA Commands 

Commands for DELTA and XDELTA work identically. With few exceptions, 
DELTA and XDELTA have the same commands. DELTA has two commands 
that XDELTA does not: EXIT and ;M. XDELTA defines some symbols that 
DELTA does not. These differences are noted where these commands and 
symbols are discussed. 

This section describes how to use DELTA and XDELTA commands to 
perform debugging operations. In addition, this section describes how to form 
symbolic expressions, arguments to many DELTA and XDELTA commands. 
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DELTA/XDELTA 

Description 


3.1 


Symbols Supplied by DELTA and XDELTA 


DELTA and XDELTA define symbols that are useful in forming expressions 
and referring to registers. The symbols are the following: 


Symbol Value 

. The current address, the address of the current location. The value of 

this symbol is set by the open-location-and-display-contents (/), the 
open-location-an d-dis play-instruction (I), and the open-location-and- 
display-indirect ( |tab| ) commands. 

Q The last value displayed. The value of Q is set by every command 

that causes DELTA or XDELTA to display the contents of memory. 

Xn Base register n, where n can range from 0 to F (hexadecimal). These 

registers are used for storing values, most often the base addresses 
of data structures in memory. 

XDELTA, but not DELTA, uses XE and XF to store the addresses 
of two command strings that XDELTA stores in memory. See the 
execute-command-string command for more information. 

XDELTA, but not DELTA, also uses registers X4 and X5 to contain 
useful addresses. X4 contains SCH$GL_CURPCB, the symbolic 
address of the location that contains the address of the PCB of the 

current process. X5 contains SCH$GI_PCBVEC, the symbolic address 

of the start of the PCB vector, the list of PCB slots. 

Rn General register n, where n can range from 0 to F (hexadecimal). Note 

that RF+4 is the processor status longword (PSL), and RE is the stack 
pointer. 

Pn The internal processor register at processor address n, where n can 

range from 0 to 3F (hexadecimal). See the VAX Hardware Handbook 
for a description of these processor registers. 

G "X80000000, the prefix for system space addresses. G2E, for 

example, is equivalent to "X8000002E. 

H ''X7FFE0000, the prefix for addresses in the control region (PI space). 

H2E, for example, is equivalent to ''X7FFE002E. 



3.2 


Forming Numeric Expressions 

Expressions are combinations of numbers, symbols that have numeric values, 
and arithmetic operators. XDELTA stores and displays all numbers in 
hexadecimal. It also interprets all numbers as hexadecimal. 

Expressions are formed using regular (infix) notation, rather than Polish or 
reverse Polish notation. XDELTA ignores operators that trail the expression. 
The following is a typical expression: 

G4A32+24-. 


XDELTA evaluates expressions from left to right, and no operator takes 
precedence over any other. Trailing operators are ignored. 
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DELTA/XDELTA 

Description 


XDELTA recognizes five binary arithmetic operators, of which one also acts 
as a unary operator. They are listed below. 


Operator 

Action 

+ or 1 SPACE I 

Addition 

- 

Subtraction, when used as a binary operator, or negation, 
when used as a unary operator 

» 

Multiplication 

% 

Division 

@ 

Arithmetic shift 


The example below shows the arguments required by the arithmetic-shift 
operator. 

n<9 j 

In the example above, n is the number to be shifted, and j is the number 
of bits to shift it. If j is positive, n is shifted to the left; if j is negative, n 
is shifted to the right. Argument j must be less than 20 (hexadecimal) and 
greater than -20 (hexadecimal). Bits shifted beyond the limit of the longword 
are lost. Argument n must be less than or equal to FFFFFFFF (hexadecimal). 
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DELTA/XDELTA 

Commands 


COMMANDS 


The commands for DELTA and XDELTA act identically. Except for a few 
commands, DELTA and XDELTA have the same commands. The EXIT and 
Set-All-Processes-Writeable (;M) commands are only used with DELTA. 

All other commands described in this section are for use with both DELTA 
and XDELTA, but in most cases only DELTA is mentioned. Any differences 
in using a command with DELTA or XDELTA, such as the fact that EXIT is 
used only with DELTA, are stated in the description of the command. 
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DELTA/XDELTA 

return i (Close Current Location) 


I RETURNI (Close Current Location) 



Closes a location that has been opened by an open-and-display 
command. 

FORMAT 

RETURN 

DESCRIPTION 

Pressing the RETURN key causes one of several actions, depending on the 
context in which you press it. It acts as a terminator for all other commands. 
Also, if you have opened a location with one of the open-and-display 
commands, the RETURN key closes that location. Further, it acts as an 

ASCII character within quoted strings. 

See the individual descriptions of the open-and-display commands; see 
the description of the deposit-ASCII-string command (') for information on 
quoted strings. 
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i linefeed i (Close Current Location, Open Next) 


| LINEFEED | (Close Current Location, Open Next) 



Closes the currently open location and opens the next location, 
displaying its contents. 

FORMAT 

LINEFEED 

DESCRIPTION 

The close-current-location-open-next command closes the currently open 
location, then opens the next and displays its contents. This command 
accepts no arguments, and thus can only be used to open the next location. It 
is useful for examining a series of locations one after another. 
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DELTA/XDELTA 

fiscl (Open and Display Previous Location) 


[He] (Open and Display Previous Location) 



Opens the previous location and displays its contents. 

FORMAT 

ESC 

DESCRIPTION 

The open-and-display-previous-location command decrements the location 
counter (.) by the width (in bytes) of the prevailing display mode, opens 
that many bytes, and displays their contents. The address of the location 
is displayed on a new line, followed by a slash (/) and the contents of that 
address. The contents are displayed in the prevailing display mode. 

This command is ignored if the prevailing display mode is instruction mode. 
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- (Display Value of Expression) 


= (Display Value of Expression) 

Evaluates an expression and displays its value. 


FORMAT 

expression = 

argument 

expression 

The expression to be evaluated 


DESCRIPTION The display-value-of-expression command evaluates an expression and 

displays its value. The expression can be any valid DELTA expression. See 
Section 3.2 for a description of DELTA expressions. 

DELTA displays the value of the expression as a hexadecimal number. 
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;E (Execute Command String) 


;E (Execute Command String) 

Executes a string of DELTA commands stored in memory. 


FORMAT 

address-expression ;E 

arguments 

address-expression 

The address of the string of DELTA commands to execute 

DESCRIPTION 

The execute-command-string command executes a string of DELTA 
commands. The commands must be stored in memory as ASCII text. See 
deposit-ASCII-string command (') for information on how to store strings in 
memory. 

If you want DELTA to proceed with program execution after it executes the 
string of commands, end the command string with the ;P command. If you 
want DELTA to wait for you to type command after it executes the string of 
commands, end the command string with a null byte (a byte containing 0). 

XDELTA, but not DELTA, provides two command strings in memory. The 
addresses of these command strings are stored in XE and XF. The string 
addressed by XE displays the PFN database for the PFN in X0. The string 
addressed by XF copies the PFN in R0 to base register X0, then displays the 
PFN database for that PFN. 

You can use these command strings to obtain the following information. 

• Specified physical page number (PFN) 

• PFN state 

• PFN type 

• PFN reference count 

• PFN backward link or working-set-list index 

• PFN forward link or share count 

• The page table entry (PTE) that points to this PFN 

• The PFN backing-store address 

• Virtual block number in the process swap image, the block to which this 
page's entry in the SWPVBN array points 
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;G (Go) 


;G (Go) 

Continues program execution. 

FORMAT 

address-expression ;G 

arguments 

address-expression 

The address at which to continue program execution 

DESCRIPTION 

The go command places the address specified by address-expression into the 
PC, and to continue execution of the program at that address. 

EXAMPLE 


45F80;G 

This command places 45F80 into the PC, and then begins execution of the 
program at that address. 
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/ (Open Location and Display Contents in Prevailing Mode) 


/ (Open Location and Display Contents in 
Prevailing Mode) 

Opens a location and displays its contents in the prevailing display 



mode. 

FORMAT 

[pid:][addr-exp] old [new-exp] 

arguments 

pid 

The internal PID of the process for which you want to display the contents 
of a location; if zero is specified, the process is that in which you are running 
DELTA. 

Use of this parameter causes subsequent open-location-and-display 
commands to display the contents of locations in this process until another 
PID is specified with this command. 

You can obtain the internal PID of the processes of interest by running SDA 
and using SDA's SHOW SUMMARY command. 

addr-exp 

The address of the location to be opened, or the range of addresses to be 
opened 

old 

This is actually not a parameter, but is the representation, in the prevailing 
display-mode, of the contents of the location or range of locations specified 
by the pid and addr-exp arguments. 

new-exp 

An expression, the value of which is to be deposited into the location. If 
specified, and if a process-id is also specified, you must have already set the 
target process to be writeable by means of the ;M command. 

DESCRIPTION 

The open-location-and-display-contents-in-prevailing-mode command opens 
the location at address-expression and displays old-contents, the contents 
of that location, in hexadecimal format. You can place a new value in the 
location by specifying an expression as shown above. If you place a new 
value in the location, the old contents are lost. 

To display a range of locations, the address-expression parameter is the first 
address in the range, followed by a comma, followed by the last address in 
the range. 

This command changes the current address (.) to the contents of the opened 
location. It also sets the prevailing display mode from instruction-mode to 
hexadecimal-mode. 
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DELTA/XDELTA 

/(Open Location and Display Contents in Prevailing Mode) 


Note that a subsequent close-location command does not change the current 
address; but a subsequent close-current-and-open-next command closes the 
location opened by the open-and-display-location command, adds to the 
address of that location the number of bytes in the prevailing display mode, 
makes that the current address, and then opens that location and displays its 
contents. 

In DELTA, but not XDELTA, you can examine the address space of any 
existing process, provided your process has CMKRNL privilege. To do so, the 
format of the open-location-and-display-contents command is as follows: 

process-id:address-expression/contents-of-location 

The process-id argument is the internal PID of the process in which you 
want to examine locations. The other arguments are the same as those used 
to examine a location in your current process. 


EXAMPLES 

Q expression-1/ expression-2 / expression-3 

The first command, expression-1/, opens the location addressed by 
expression-1 and displays the contents of that location, expression-2. 

The next open-location-and-display-contents command opens the location 
addressed by expression-2 and displays expression-3, the contents of that 
location. 

Q start-addr-expression, end-addr-expression/contents-of-start-addr 
second-addr/ contents-of-second-addr 
third-addr/contents-of-third-addr 


end-addr/ c ont ents-of-end-addr 

This example shows the open-and-display-contents-in-prevailing-mode 
command used with a range of addresses. This command displays the 
contents of the first location, then the address and contents of each 
subsequent location within the range. 
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DELTA/XDELTA 

! (Open Location and Display Contents in Instruction Mode) 


! (Open Location and Display Contents in 
Instruction Mode) 

Displays an instruction and its operands. 


FORMAT 


address-expression 


arguments 


address-expression 

The address of the instruction to display 


DESCRIPTION The open-location-and-display-contents-in-instruction-mode command 

displays the contents of memory as a MACRO instruction, starting with 
the address you specify. DELTA does not make any distinction between 
reasonable and unreasonable instructions or instruction streams; the decoding 
always begins at the specified address. 

This command does not allow you to modify the contents of the location. 
The command sets a flag that causes subsequent close-current-and-display- 
next or open-and-display-indirect-location commands to perform instruction 
decoding. You can clear the flag by using the open-location-and-display- 
contents command, which displays the contents of the location as a 
hexadecimal number. 

When an address appears as an instruction's operand, DELTA sets the Q (the 
last-quantity-displayed variable) to that address. DELTA changes Q only for 
operands that use program-counter or branch-displacement addressing modes; 
Q is not altered for operands that use literal and register addressing modes. 
This feature is useful for following branches, as shown in the example below. 


EXAMPLE 

address-expression !!BRW address-2 !!MOVL R1,R3 

In this example, address-expression is the address of the first instruction to 
display. DELTA displays the instruction, BRW, and its operand, address- 
2. Because this operand does not use literal addressing or register-mode 
addressing, DELTA sets Q to be address-2. 

The second display-instruction command uses the value of Q, the default 
address, as its argument. It displays MOVL, the instruction at location 
address-2, and its operands, R1 and R3. 
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DELTA/XDELTA 

[tab] (Open and Display Indirect Location) 


^(Open and Display Indirect Location) 

Opens the location addressed by the contents of the current 
location, and displays its contents. 


FORMAT 


DESCRIPTION The open-and-display-indirect-location command opens the location 

addressed by the contents of the current location, and displays its contents. 
The display is made in the prevailing display mode. This command is useful 
for examining data structures that have been placed in a queue, or the 
operands of instructions. 

This command changes the current address (.) that of the location displayed. 
This command does not effect the display mode. 


EXAMPLE 

addre88-expre88ion/addre88-expre8sion-2 [TAB] 
addre88-expre8sion-2/content8-of-addres8-expre88ion-2 

The open-and-display-contents command opens the location 
at address-expression, and displays that location's contents, 
address-expression-2. The open-location-and-display-indirect command 
opens the location addressed by the value of Q, the last value displayed, 
which in this case is address-expression-2. 
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DELTA/XDELTA 

;P (Proceed from Breakpoint) 


;P (Proceed from Breakpoint) 

Causes DELTA to continue program execution following the 
encounter of a breakpoint. 


FORMAT ;P 


DESCRIPTION The proceed-from-breakpoint command causes DELTA to continue program 

execution at the address contained in the program's PC. 
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DELTA/XDELTA 

"(Open and Display Contents in ASCII) 


"(Open and Display Contents in ASCII) 

Displays the contents of a location as an ASCII string. 


FORMAT 

address-expression " 

arguments 

address-expression 

The address of the location whose contents are to be displayed 


DESCRIPTION The open-and-display-contents-in-ASCII command causes DELTA to open 

the location at address-expression and display its contents in ASCII format. 



The display mode remains ASCII until the next open-and-display-location 
command (/) or display-instruction command (!). These commands change 
the display mode to hexadecimal or instruction, respectively. The width 
of the location displayed, byte, word, or longword, remains unchanged by 
the open-location-and-display-contents-in-prevailing-mode command, but is 
changed by the open-location-and-display-instruction command. 

EXAMPLE 


235FC2 [W/415A 

235FC2"ZA 1 LINEFEED I 
235FC4/PP 

The open-location-and-display-ASCII command (") changes the prevailing 
display mode to ASCII, but does not affect the width of the display. The next 
open-and-displav-next command (1 linefeed I ) determines the address of the 
location to open by adding the width, in bytes, to the value of ., then opens 
the number of bytes equal to the width of the prevailing display mode, which 
in this case is two bytes. 

Note that the ASCII representation of the contents of the location presents 
the bytes left to right, whereas the hexadecimal representation presents them 
right to left. 
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DELTA/XDELTA 

;X (Load Base Register) 

;X (Load Base Register) 

Places an address in a base register. 


FORMAT 

address-expression,n ;X 


arguments 

address-expression 

The address to place in the base register 

n 

The number of the base register 



DESCRIPTION To place an address in a base register, type an expression followed by a 

comma (,), a single digit between 0 and D (hexadecimal), a semicolon (;), and 
the letter X. DELTA places the specified expression in base register n. DELTA 
confirms that the base register is set by displaying the value deposited in the 
base register. 

When DELTA displays an address that is within 800 (hexadecimal) bytes 
of an address stored in a base register, DELTA displays the base register 
identifier (Xn), followed by an offset that gives the address's location in 
relation to the address stored in the base register. If the address falls outside 
this range, DELTA displays it as a hexadecimal value. 

If base register 2 contains 800D046A, for example, and the address an DELTA 
command needs to display is 800D052E, DELTA displays that address as 
X2+C4. DELTA computes relative addresses for both opened or displayed 
locations, and for addresses that are instruction operands. 

DELTA and XDELTA provide symbols that make it easy to refer to processor, 
general, and base registers. See Section 3.1 for a description of these symbols. 
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DELTA/XDELTA 

;B (Breakpoint) 


;B (Breakpoint) 


Shows, sets, and clears breakpoints. 

FORMAT 

[addr][,n][,display][,cmd] -,B 

arguments 

addr 

The address at which to set the breakpoint 


n 

The number to assign to this breakpoint, a number between 2 and 8. If 
omitted, DELTA assigns the first unused number to the breakpoint; if all 
numbers are in use, DELTA displays its only error message, "EH?". 


display 

The address of a location, the contents of which are to be displayed in the 
prevailing display mode when this breakpoint is encountered. If omitted, 
DELTA displays only the instruction that begins at the specified address. 


cmd 

The address of the string of DELTA commands to execute when this 
breakpoint is encountered. If omitted, DELTA executes no commands 
automatically, but waits for you to enter commands interactively. 

DESCRIPTION 

The breakpoint command shows, sets, and clears breakpoints. The action 
of this command depends on the arguments used with it. Each action is 
described below. 


Displaying Breakpoints 

To show all the breakpoints currently set, type ;B. For each breakpoint, 
DELTA displays the following information: 

• The number of the breakpoint 

• The address at which the breakpoint is set 

• The address of a location whose contents are to be displayed when the 
breakpoint is encountered 

• The address of the command string associated with this breakpoint (for 
complex breakpoints) 

Setting Breakpoints 

To set a breakpoint, type an address followed by a semicolon (;), the letter B, 
then press RETURN, as shown below. 

addr-exp; B 1 RETURN 1 

DELTA sets a breakpoint at the specified location, and assigns it the first 
available breakpoint number. 
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DELTA/XDELTA 

;B (Breakpoint) 






Before DELTA executes the instruction at which a breakpoint is set, it 
suspends normal instruction processing, and sets a flag that causes subsequent 
close-and-display-next or display-indirect-location commands to perform 
instruction decoding. Then it displays the following message, where n is the 
number of the breakpoint. 

n BRK at address 
address/decoded-instruction 

When the display appears, you can enter other DELTA commands. You can 
reset the flag that controls the mode in which instructions are displayed by 
issuing the open-location-and-display-contents command. 

Setting a Breakpoint and Assigning a Number to It 

To set a breakpoint and assign it a number, type an address followed by a 
comma, a single digit between 2 and 8, a semicolon (;), the letter B, and then 
press RETURN, as shown below. 

addr-exp, n; B [RETURN | 

DELTA sets a breakpoint at the specified location and assigns it the specified 
breakpoint number. Note that breakpoint 1 is reserved for INI$BRK in 
XDELTA, but is undefined for DELTA. 

Clearing Breakpoints 

To clear a breakpoint, type zero (0), followed by a comma, the number of the 
breakpoint to remove, a semicolon (;), the letter B, and then press RETURN. 
DELTA clears the specified breakpoint. 

When using XDELTA, do not clear breakpoint 1. If you do, any breakpoint 
instructions you have coded into your driver will result in unrecognized- 
breakpoint exceptions. 

The following shows an example of clearing breakpoint n. 

0,n;B [RETURN] 

Setting Complex Breakpoints 

A complex breakpoint is one that, when encountered, performs the actions 
listed below. 

• Displays the next instruction to be executed 

• Displays the contents of another, specified location 

• Executes a string of DELTA commands stored in memory 

The string of commands executes after the instruction is displayed. See 
the deposit-ASCII-string command (') for information on storing a string of 
DELTA commands in memory. 

To set a complex breakpoint, type the ;B command as shown below. 

addr-exp,n.display-addr-exp.cmd-string-addr;B 

The addr-exp is an expression whose value is the location at which the 
breakpoint is to be set. 

The n is the number to assign to this breakpoint. The number of the 
breakpoint can range from 1 to 8. 
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DELTA/XDELTA 

;B (Breakpoint) 


The display-addr-exp is an expression, the value of which is the address 
of a location whose contents are to be displayed when this breakpoint is 
encountered. 

The cmd-string-addr is an expression, the value of which is the address 
of the string of DELTA commands to be executed when this breakpoint is 
encountered. DELTA displays the information requested before executing the 
string of commands associated with complex breakpoints. 


DELTA-26 




DELTA/XDELTA 

[ (Set Display Mode) 


[ (Set Display Mode) 

Sets the mode of the displays produced by DELTA commands 


FORMAT [ mode 


arguments mode 

A letter that indicates the mode in which the display is made, one of the 
following: 


Mode Meaning 

B Byte mode. In this mode each open-and-display-location command 

displays the contents of one byte of memory. 

I Instruction mode. In this mode each open-and-display-location command 

displays the contents of memory as an instruction and its operands, 
displaying as many bytes of memory as necessary to display all 
operands. 

L Longword mode. In this mode each open-and-display-location command 

displays the contents of a longword of memory. This is the default 
mode. 

W Word mode. In this mode each open-and-display-location command 
displays the contents of one word of memory. 


DESCRIPTION The set-display-mode command changes the prevailing display width to byte, 

word, or longword. The default display width is longword. The display mode 
remains in effect until you give another display-mode command. 

To change the prevailing display mode to instruction format, type [I. This 
command is equivalent to the display-instruction command, and, similarly, 
is canceled by typing an open-and-display-location command (/ or !) or an 
open-and-display-location-in-ASCII (") command. 

Setting the display mode to instruction mode also sets display mode to 
longword, as does the set-display-mode command used with the L argument. 


EXAMPLE 

address-expression [B/ old-value new-value 

This command displays the least significant byte contained at the address 
address-expression, and deposits new-value in that byte. 
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DELTA/XDELTA 

S (Step Instruction) 


S (Step Instruction) 

Executes one instruction and displays the next, stepping into a 



subroutine, if the instruction is a call to a subroutine, and displaying 
the next instruction to be executed. 

FORMAT 

s 

DESCRIPTION 

The step-instruction command causes DELTA to execute one instruction, 
display the address of the next instruction, and display that next instruction. 

This command also sets a flag that causes subsequent close-and-display-next 
or display-indirect-location commands to perform instruction decoding. The 
open-location-and-display-contents command clears the flag, causing the 
display mode to revert to longword, hexadecimal mode. 

If the next instruction is BSBB, BSBW, JSB, CALLG, or CALLS, this command 
executes that instruction and displays the first instruction within the 
subroutine. 
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O (Step Instruction Over Subroutine) 


O (Step Instruction Over Subroutine) 

Executes one instruction and displays the next, stepping over a 



subroutine by executing it and displaying the instruction to which 
the subroutine returns control. 

FORMAT 

O 

DESCRIPTION 

The step-instruction-over-subroutine command causes DELTA to execute one 
instruction, display the address of the next instruction, and display that next 
instruction and its operands. 

This command also sets a flag that causes subsequent close-and-display- 
next or open-and-display-indirect-location commands to perform instruction 
decoding. The open-and-display command clears the flag. 

If the next instruction is BSBB, BSBW, JSB, CALLG, or CALLS, DELTA 
executes the subroutine and displays the instruction to which the subroutine 
returns control. This command is said to "step over "subroutines. 
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DELTA/XDELTA 

;M (Set All Processes Writeable) 


;M (Set All Processes Writeable) 

Sets the address spaces of all processes to be writeable or 



read-only by your DELTA process. This command can be used 
only with DELTA. This command requires CMKRNL privilege. 

FORMAT 

n ;M 

argument 

n 

If 0, your DELTA process can only read locations in other processes; if 1, your 
process can read or write any location in any process; if not specified, DELTA 
returns the current value of the M (modify) flag (0 or 1). 

DESCRIPTION 

This command is useful for changing values in the running system. This is, of 
course, an activity that must be pursued only with the greatest of care during 
timesharing. For this reason, your process must have change-mode-to-kernel 
(CMKRNL) privilege to use this command. It is safest to use this command 
only on a stand-alone system. 
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(Deposit ASCII String) 


'(Deposit ASCII String) 

Deposits the ASCII string at the current address 


FORMAT 

'string' 

arguments 

string 

The string of characters to be deposited 

DESCRIPTION 

The deposit-ASCII-string command deposits string at the current location 
(.) in ASCII format. The second apostrophe is required syntax. It ends 
the string. All characters typed between the first and second apostrophes, 
including linefeed and carriage return, are entered as text. 

This command stores the characters in eight-bit bytes, and increments the 
current address (.) by one for each character stored. 

This command does not change the prevailing display mode. 
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